home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / util / conv / raw2ent1.rea < prev    next >
Text File  |  1997-03-02  |  6KB  |  141 lines
  1. Short:    Entity-Codes, Alternatives, Color-Codes
  2. Author:   honma@thepentagon.com (Tamio Patrick Honma)
  3. Uploader: honma@thepentagon.com (Tamio Patrick Honma)
  4. Version:  1.8.2
  5. Type:     util/conv
  6. Replaces: util/conv/Raw2Ent*
  7.  
  8.  
  9. This  program  is  usefull  for  HTML-Develpers  and  can  also  be used for
  10. Internet-,  Compuserve-, FIDO-, ZCONNECT-Newsgroups and eMails.  It supports
  11. the ability to convert 8Bit-characters into 7Bit-characters and reverse with
  12. the  help  of  character-entity-codes  or  -names or alternative characters.
  13. Additionaly   it   can  convert  HTML  3.2-  and  Netscape-color-names  into
  14. color-codes and reverse.
  15.  
  16. This program is written in 100% assembly language for the Motorola MC68000.
  17. It runs on every AmigaOS 2.0 and higher.  It may run under pOS - please
  18. report!
  19.  
  20. A GUI is not implemented at this moment, but an ARrexx-Script adds this
  21. program into Cygnus ED's Interface.
  22.  
  23.  
  24.  
  25. Files: Raw2Ent               1.8.2 (22.01.97)
  26.        Raw2Ent.ced           1.01  (26.12.96)
  27.        Raw2Ent.doc           english documentation
  28.        Raw2Ent.dok           german documentation
  29.        Raw2Ent.rexx          1.4.1 (14.07.96)
  30.        Raw2Ent.rexx.old      1.3.4 (01.11.96)
  31.        Raw2EntCheck          1.0   (12.12.96)
  32.        Raw2EntHTMLColors.iff HTML 3.2-Color-Names, -Codes and -Colors
  33.        Raw2EntLogic.asc      logical-structure documentation
  34.        Raw2EntMeta.asc       meta-structure documentation
  35.        Raw2EntTables.doc     code-tables documentation
  36.  
  37.  
  38.  
  39. WHAT'S NEW SINCE LAST RELEASE?
  40.     List-Modes added to Raw2Ent
  41.     and Color-Code-Picture included into package.
  42.  
  43. NOTE: Since version 1.8:
  44.     HTML 3.2 and Netscape Color-Code and Color-Name convertion included!
  45.  
  46. NOTE:  Since version 1.7:
  47. "Cygnus ED"-Support included
  48.  
  49. NOTE:  Since version 1.6.3:
  50. The NOBACKUP-Feature will switch off the new backup-feature.
  51. Now the destination- and source-file may have the same names!
  52.  
  53. NOTE:  Since version 1.5 you can use Raw2Ent as an Ent2Raw!
  54.  
  55. NOTE:   Since  version  1.3  you can use Raw2Ent as a "Raw2Uml", which means
  56. that  the  destination  file  will  contain  readable  characters,  words or
  57. shortcuts.  (i.e.:  "ü" -> "ue", "£" -> "pound", "©" -> "(C)", etc.)
  58.  
  59.  
  60. FAST INTRODUCTION: (see below for a larger introduction)
  61. Raw2Ent can convert
  62.  
  63. 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with Character-Entity-Codes
  64. example:            "Hallöchen" -> "Hallöchen"
  65.  
  66.    7Bit-ASCII with Entity-Codes -> 8Bit-ASCII (ISO-8859-1 [Amiga])
  67. example:         Hallöchen -> Hallöchen
  68.  
  69. 8Bit-ASCII (ISO-8859-1 [Amiga]) -> 7Bit-ASCII with alternative characters
  70. example:            "Hallöchen" -> "Halloechen"
  71.  
  72. HTML32- or NETSCAPE-COLOR-NAMES -> HTML-Color-Codes
  73. example:          BGCOLOR="Red" -> BGCOLOR="#FF0000"
  74.  
  75.                HTML-Color-Codes -> HTML32- or NETSCAPE-COLOR-NAMES
  76. example:      BGCOLOR="#FF0000" -> BGCOLOR="Red"
  77.  
  78.  
  79.  
  80. INTRODUCTION
  81.  
  82. Raw2Ent   converts   raw   8-Bit-ASCII-Text   into   7-Bit-ASCII-Text   with
  83. entity-codes  and  reverse.   The  ASCII-Format is a standardized format for
  84. information  interchange,  but it is only standardized seven-bit-wide, which
  85. means  that  128 codes are defined.  One Byte consists of eight bits and can
  86. represent  256  different  bit  combinations.   Therefore  the  last 128 bit
  87. combinations  are defined for free use by any operation-system.  The problem
  88. is that accent-characters and other special characters are not standardized,
  89. because  they  are defined in (guess where?!  ;) ) the free part of ASCII by
  90. the operation system developers.
  91.  
  92. The  goal of the Wold Wide Web developers was that it could be used on every
  93. important   operation   system.   So  it  was  clear  that  the  ASCII-Based
  94. HTML-Source-Code   had  to  use  the  standardized  seven-bit  area  of  the
  95. ASCII-Code.  To represent accent-characters or other special characters in a
  96. seven-bit-code,  it  was  neccesary  to  invent something.  And this was the
  97. entity-code  -  a  kind  of  escape-code.   An  entity-code  consists  of an
  98. introducing  "&"  and  a  ";"  at  the  end.   Between  these  symbols  is a
  99. character-name the browser can interpret.  It is a very hard and stupid work
  100. to convert the ASCII-Text by hand.  So just use Raw2Ent!
  101.  
  102. Raw2Ent  produces  real 7-Bit-ASCII-Code.  All printable Amiga-characters in
  103. the  8-bit-area  will be converted into entity-codes, without any exception.
  104. The  use  of names instead of code-numbers will make the entity-codes easier
  105. to be read by humans.  If no name was defined in the HTML 3.2 reference, the
  106. code-number will be used.
  107.  
  108. You  can use Raw2Ent also to check, wether your file contains pure seven-bit
  109. codes  or  not.   If  not,  Raw2Ent  will  present  you  the position of the
  110. 8-Bit-Characters in the text.
  111.  
  112. Raw2Ent can also handle color-codes and -names.
  113.  
  114.  
  115. SEND COMMENTS TO:
  116.  
  117. Tamio Patrick Honma
  118.  
  119. eMail: honma@thepentagon.com
  120.   WWW: http://www.netforward.com/thepentagon/?honma
  121.  
  122.                       *>> Love all over the world! <<*
  123.  
  124.  
  125. ============================= Archive contents =============================
  126.  
  127. Original  Packed Ratio    Date     Time    Name
  128. -------- ------- ----- --------- --------  -------------
  129.     9884    5036 49.0% 22-Jan-97 02:07:58  Raw2Ent
  130.    21607    7730 64.2% 22-Jan-97 02:43:18  Raw2Ent.doc
  131.    23672    8636 63.5% 22-Jan-97 02:50:58  Raw2Ent.dok
  132.     1131     580 48.7% 17-Nov-96 23:07:06  Raw2Ent.rexx
  133.     5120    1482 71.0% 17-Nov-96 23:07:06  Raw2Ent.rexx.old
  134.      465     287 38.2% 12-Dec-96 13:11:32  Raw2EntCheck
  135.    14604    2587 82.2% 27-Dec-96 03:24:00  Raw2EntHTMLColors.iff
  136.     1489     322 78.3% 26-Dec-96 16:28:44  Raw2EntLogic.asc
  137.     1227     255 79.2% 13-Dec-96 00:07:34  Raw2EntMeta.asc
  138.     4866    2201 54.7% 27-Dec-96 14:21:32  Raw2EntTables.doc
  139. -------- ------- ----- --------- --------
  140.    84065   29116 65.3% 01-Feb-97 23:12:54   10 files
  141.